Software User's Guide Version 3.4
This chapter describes the V.25 bis configuration and operational
commands and GWCON commands. It includes the following sections:
Use the following procedure to access the V.25 bis configuration
process.
- At the OPCON prompt, enter the talk command and the PID for
CONFIG. (For more detail on this command, refer to "What is the OPCON Process?".) For example:
* talk 6
Config>
After you enter the talk 6 command, the CONFIG prompt
(Config>) displays on the console. If the prompt does not
appear when you first enter CONFIG, press Return
again.
- At the CONFIG prompt, enter the list devices command
to display the network interface numbers for which the router is currently
configured.
- Record the interface numbers.
- Enter the CONFIG network command
and the number of the interface you want to configure. For
example:
Config> network 1
V.25bis Config>
The V.25 bis configuration prompt now displays on the
console.
Table 62 summarizes and the rest of the section explains the
V.25 bis configuration commands. These commands allow you to
display, create, or modify a V.25 bis configuration. Enter the
V.25 bis configuration commands at the V.25bis
Config> prompt.
Table 62. V.25 bis Configuration Commands Summary
| Command
| Function
|
| ? (Help)
| Displays all the commands available for this command level or lists the
options for specific commands (if available). See "Getting Help".
|
| List
| Displays the V.25 bis configuration.
|
| Set
| Sets the local address, connect, disconnect, and no answer timeouts,
number of retries after no answer, the duplexing mode, command delay timeout,
and encoding.
|
| Exit
| Returns you to the previous command level. See "Exiting a Lower Level Environment".
|
Use the list command to display the current V.25 bis
configuration.
Syntax:
- list
-
Example:
list
V.25bis Configuration
Duplex = Full
Encoding = NRZ
Local Network Address Name = v403
Local Network Address = 15088982403
Non-Responding addresses:
Retries = 1
Timeout = 0 seconds
Call timeouts:
Command Delay = 0 ms
Connect = 60 seconds
Disconnect = 2 seconds
Cable type = V.35 DTE
Speed = 9600
- Duplex
- Displays the duplex mode for the interface once the dial connection has
been established.
- Encoding
- Displays the transmission encoding scheme for the interface once the dial
connection has been established. Encoding is either NRZ (non-return to
zero) or NRZI (non-return to zero inverted).
- Local Network Address Name:
- Displays the network address name of the local port.
- Local Network Address:
- Displays the network dial address of the local port.
- Non-responding addresses:
-
- Retries
- Maximum number of calls the router attempts to make to a non-responding
address during the timeout period.
- Timeout
- If the router reaches the maximum number of retries to a non-responding
address, it does not attempt to establish the call until this time has
expired. This timeout period begins when the router attempts the first
call.
- Call timeouts:
- Number of call timeouts.
- Command Delay
- Amount of time, in milliseconds, that the router waits to initiate or
answer a call after it turns on DTR (Data Terminal Ready). If you set
this parameter to 0, the router waits for the modem to respond to DTR with the
CTS (Clear to Send) signal before it issues commands.
- Connect
- Number of seconds allowed for a call to be established. If this
parameter is set to 0, the modem controls the connection establishment
timeout.
- Disconnect
- After the routers drops DTR it waits this amount of time before it
initiates further calls. If you set this parameter to 0, the router
waits for the modem to respond to the DTR drop by dropping CTS and DSR before
it initiates the next call.
Use the set command to configure local addresses, timeouts and
delays for calls, retries and timeouts for non-responding addresses, and the
HDLC cable type.
Syntax:
- set
- command-delay timeout . . .
-
- connect-timeout . . .
-
- disconnect-timeout . . .
-
- duplex
-
- hdlc cable . . .
-
- hdlc encoding . . .
-
- hdlc speed . . .
-
- local-address . . .
-
- retries-no-answer . . .
-
- timeout-no-answer . . .
- command-delay-timeout # of milliseconds
- After the router turns on DTR (Data Terminal Ready), it waits this amount
of time before it initiates or answers a call. If you set this
parameter to 0, the router waits for the modem to respond to DTR with the CTS
(Clear to Send) signal before it issues commands. The range is 0 to
65535 milliseconds, and the default is 0.
- connect-timeout # of seconds
- Sets the number of seconds allowed for a call to be established.
The range is 0 to 65535 seconds, and the default is 60. If you set this
parameter to 0, the modem controls the connection timeout. You should
initially set this parameter to 0 and then use ELS event V25B.027 to
find out how long it takes to establish connections to various
destinations. You can then set this parameter to a number slightly
higher than the longest connect time.
| Note: | Normally government regulation limits modem manufacturers to a maximum length
for call setup. This value is merely an optimization, although
inter-operation with some DSUs may require that you change this
parameter.
|
- disconnect-timeout # of seconds
- Specifies the amount of time, in seconds, that the router waits after
dropping DTR before it initiates further calls. The range is 0 to 65535
seconds, and the default is 2. If you set this parameter to 0, the
router waits for the modem to respond to the DTR drop by dropping CTS and DSR
before it initiates the next call.
- duplex
- Specifies the duplex type of the line.
When full-duplex is configured, the RTS modem signal remains asserted once
the dial connection has been established.
When half-duplex is configured, the router raises RTS when it is time to
transmit and waits for CTS to be asserted by the modem. After CTS is
asserted, the router transmits data packets and then drops RTS when the router
is through transmitting to let the peer device respond.
Only configure half-duplex when using the V.25 bis interface to
handle switched SDLC and the attached modem requires the half-duplex mode of
operation.
Notes:
- Duplex must be full for PPP or Frame Relay circuits.
Valid values: full or half
Default value: full
- hdlc cable rs232 dte
- Specifies the type of cable connected to this interface. Setting
this parameter allows you to view the cable type when you enter the
interface command at the GWCON (+) prompt and when you enter the
statistics command at the V.25bis> monitoring
prompt. This parameter does not affect operation of the router.
- hdlc encoding
- Sets the HDLC transmission encoding scheme as NRZ (non-return to zero) or
NRZI (non-return to zero inverted). Most configurations use NRZ.
The configured encoding is used for the end-to-end connection.
| Note: | Although you might configure NRZI, the exchange between the DTE and the modem
(as described by CCITT recommendation, V.25 bis) uses NRZ as the encoding scheme.
|
Valid values: NRZ or NRZI
Default value: NRZ
- hdlc speed
- Specifies the line speed for this interface. Setting this parameter
allows you to view the line speed when you enter the interface command at the
GWCON (+) prompt and when you enter the statistics command at the
V.25bis> monitoring prompt. The range is 2400 to
64 000 bps. The default is 9600 bps.
| Note: | This command does not affect the actual line speed but it sets the speed some
protocols, such as IPX, use when calculating routing cost parameters for dial
circuits mapped to the V.25 bis interface.
|
- local-address address name
- Specifies the network address name of the local port. This address
name must match one of the names that you defined at the
Config> using the add v25-bis-address
command.
Example: set local-address
line-1-local
- retries-no-answer value
- Some telephone service providers impose restrictions on automatic
recalling devices to limit the number of successive calls to an address that
is inaccessible or that refuses those calls. This parameter specifies
the maximum number of calls the router attempts to make to a non-responding
address during the timeout period. The range is 0 to 10, and the
default is 1.
| Note: | Government regulation may also impose limits on the modem manufacturer that
would supersede this parameter.
|
- timeout-no-answer # of seconds
- After the router reaches the maximum number of
retries-no-answer to a non-responding address, it does not initiate
further calls to that address until this time has expired. This timeout
period begins when the router attempts the first call to an address.
The range is 0 to 65535 seconds, and the default is 0. If you set this
parameter to 0, the modem controls the timeout period.
To access the interface monitoring process for V.25 bis, enter the
following command at the GWCON (+) prompt:
+ network #
Where # is the number of the V.25 bis serial
line. You cannot directly access the V.25 bis monitoring process
for dial circuits, but you can monitor the dial circuits that are mapped to
the serial line interface.
| Note: | V.25 bis interfaces also have ELS troubleshooting messages that you
can use to monitor V.25 bis-related activity. See the IBM
Event Logging System Messages Guide for further details.
|
This section summarizes and explains the V.25 bis operating
commands. These commands allow you to view the calls, circuits,
parameters, and statistics of the V.25 bis interfaces.
Enter the V.25 bis monitoring commands at the
V.25bis> prompt. Table 63 shows the commands.
Table 63. V.25 bis Monitoring Command Summary
| Monitoring Command
| Function
|
| ? (Help)
| Displays all the commands available for this command level or lists the
options for specific commands (if available). See "Getting Help".
|
| Calls
| List the number of completed and attempted connections made for each
dial circuit mapped to this interface since the last time statistics were
reset on the router.
|
| Circuits
| Shows the status of all data circuits configured on the V.25
bis interface.
|
| Parameters
| Displays the current parameters for the V.25 bis
interface. (This command is similar to the V.25bis
Config> list command.)
|
| Statistics
| Displays the current statistics for the V.25 bis
interface.
|
| Exit
| Returns you to the previous command level. See "Exiting a Lower Level Environment".
|
Use the calls command to list the number of completed and
attempted connections made for each dial circuit mapped to this interface
since the last time statistics were reset on the router.
Syntax:
- calls
-
Example:
calls
Net Interface Site Name In Out Rfsd Blckd
1 PPP/0 v403 2 0 0 0
Unmapped connection indications: 0
- Net
- Number of the dial circuit mapped to this interface.
- Interface
- Type of interface and its instance number.
- Site Name
- Network address name of the dial circuit.
- In
- Number of inbound connections accepted for this dial circuit.
- Out
- Number of completed connections initiated by this dial circuit.
- Rfsd
- Number of connections initiated by this dial circuit that were refused by
the network or the remote destination port.
- Blckd
- Number of connection attempts that the router blocked. The router
blocks connection attempts if the local port is already in use, the maximum
number of retries to a non-responding address is reached, or a modem is not
responding.
- Unmapped connection indications:
- Number of connection attempts that were refused by the router because
there were no enabled dial circuits that were configured to accept the
incoming calls.
The circuits command shows the status of all dial circuits
configured on the V.25 bis port.
Syntax:
- circuits
-
Example:
circuit
Net Interface MAC/Data-Link State Reason Duration
2 PPP/0 Point to Point Avail Rmt Disc 1:02:25
- Net
- Number of the dial circuit mapped to this interface
- Interface
- Type of interface and its instance number.
- MAC/DataLink
- Type of datalink protocol configured for this dial circuit.
- State
- Current state of the dial circuit:
- Up - currently connected
- Available - not currently connected, but is available
- Disabled - dial circuit was disabled
- Down - failed to connect because of a busy dial circuit or because the
link-layer protocol is down
- Reason
- Reason for the current state:
- nnn_Data - (where nnn is the name of a protocol) the circuit is Up because
a protocol had data to send.
- Remote Disconnect - the circuit is either Down or Available because the
remote destination disconnected the call.
- Operator Request - the circuit is Available because the last call was
disconnected by a monitoring command.
- Inbound - the circuit is Up because the circuit answered an inbound
call.
- Restoral - the circuit is Up because of a WAN Restoral operation.
- Self Test - the circuit was configured as static (idle time=0) and
successfully connected once it was enabled.
- Duration
- Length of time that the circuit has been in the current state.
Use the parameters command to display the current V.25
bis serial line configuration. Note that this is the same information
displayed in the V.25bis Config> list command.
Syntax:
- parameters
-
Example:
parameters
V.25bis port Parameters
Local Network Address Name = v402
Local Network Address = 15088982402
Non-Responding addresses:
Retries = 1
Timeout = 0 seconds
Call timeouts:
Command Delay = 0 ms
Connect = 0 seconds
Disconnect = 0 seconds
- Local Network Address Name:
- Network address name of the local port.
- Local Network Address:
- Network dial address of the local port.
- Non-responding addresses:
-
- Retries
- Maximum number of calls the router attempts to make to a non-responding
address during the timeout period.
- Timeout
- If the router reaches the maximum number of retries to a non-responding
address, it does not attempt to establish the call until this time has
expired. This timeout period begins when the router attempts the first
call to an address.
- Call timeouts:
-
- Command Delay
- Amount of time, in milliseconds, that the router waits to initiate or
answer a call after it turns on DTR (Data Terminal Ready). If you set
this parameter to 0, the router waits for the modem to respond to DTR with the
CTS (Clear to Send) signal before it issues commands.
- Connect
- Number of seconds allowed for a call to be established. If this
parameter is set to 0, the modem controls the connection establishment
timeout.
- Disconnect
- After the routers drops DTR it waits this amount of time before it
initiates further calls. If you set this parameter to 0, the router
waits for the modem to respond to the DTR drop by dropping CTS and DSR before
it initiates the next call.
Use the statistics command to display the current statistics for
this V.25 bis interface.
Syntax:
- statistics
-
Example:
statistics
V.25bis port Statistics
Adapter cable: RS-232 DTE
Nicknames: RTS CTS DSR DTR DCD RI
RS-232 CA CB CC CD CF CE
State: OFF OFF OFF OFF OFF OFF
Line speed: 4800
Last port reset: 24 seconds ago
Input frame errors:
CRC error 0 alignment (byte length) 0
missed frame 0 too long (> 2182 bytes) 0
aborted frame 0 DMA/FIFO overrun 0
L & F bits not set 0
Output frame counters:
DMA/FIFO underrun errors 0 Output aborts sent 0
- Adapter cable:
- Type of adapter cable being used.
- Nicknames:
- Common names for the circuits.
- RS-232
- EIA 232 (also known as RS-232) names for the circuits.
- State:
- Current state of the circuits: ON, OFF, or "---," which means that
the state is undefined for this type of interface.
- Line speed:
- The transmit clock speed (approximate).
- Last port reset:
- Length of time since the port was reset.
- Input frame errors:
-
- CRC error
- Number of packets received that contained checksum errors and as a result
were discarded.
- Alignment (byte length)
- Number of packets received that were not an even multiple of 8 bits in
length and as a result were discarded.
- Missed Frame
- When a frame arrives at the device and there is no buffer available, the
hardware drops the frame and increments the missed frame counter.
- too long (> nnnn bytes)
- Number of packets received that were greater than the configured frame
size (nnnn) and as a result were discarded.
- aborted frame
- Number of packets received that were aborted by the sender or a line
error.
- DMA/FIFO overrun
- The number of times the serial interface card could not send data fast
enough to the system packet buffer memory to receive packets from the
network.
- L & F bits not set
- On serial interfaces, the hardware sets input-descriptor information for
arriving frames. If the buffer can accept the complete frame upon
arrival, the hardware sets both the last and first bits of the frame,
indicating that the buffer accepted the complete frame. If either of
the bits is not set, the packet is dropped, the L & F bits not set counter
is incremented, and the buffer is cleared for reuse.
| Note: | It is unlikely that the L & F bits not set counter will be affected by
traffic.
|
- Output frame counters:
-
- DMA/FIFO underrun errors
- Number of times the serial interface card could not retrieve data fast
enough from the system packet buffer memory to transmit packets onto the
network.
- Output aborts sent
- Number of transmissions that were aborted as requested by upper-level
software.
While V.25 bis has its own monitoring process for monitoring
purposes, the router also displays configuration information and complete
statistics for devices and circuits when you use the interface, statistics,
and error commands from the GWCON environment. You can also use the
GWCON test command to test DCEs and circuits.
| Note: | Issuing the test command to the V.25 bis serial interface
causes the current call to be dropped and re-dialed.
|
For more information on the GWCON command, see The Operating/Monitoring Process (GWCON - Talk 5) and Commands.
Use the interface command at the GWCON (+)
prompt to display statistics for V.25 bis serial line interfaces and
dial circuits.
To display the following statistics for a V.25 bis serial line
interface, use the interface command followed by the interface
number of the V.25 bis serial line interface.
Example: interface 10
Self-Test Self-Test Maintenance
Nt Nt' Interface Slot-Port Passed Failed Failed
10 10 V.25/0 Slot: 4 Port: 0 1 0 0
V.25bis Base Net MAC/data-link on EIA 232E/V.24 interface
Adapter cable: RS-232 DTE
V.24 circuit: 105 106 107 108 109 125
Nicknames: RTS CTS DSR DTR DCD RI
RS-232: CA CB CC CD CF CE
State: OFF OFF OFF ON OFF OFF
Line speed: ~19.200 Kbps
Last port reset: 55 minutes, 1 second ago
Input frame errors:
CRC error 6 alignment (byte length) 0
missed frame 1 too long (> 2054 bytes) 0
aborted frame 34 DMA/FIFO overrun 0
Output frame counters:
DMA/FIFO underrun errors 0 Output aborts sent 0
To display the following statistics for a dial circuit, use the
interface command followed by the interface number of
the dial circuit.
Example:
interface 29
Self-Test Self-Test Maintenance
Nt Nt' Interface Passed Failed Failed
29 10 PPP/20 2 1 0
Point to Point MAC/data-link on V.25bis Dial Circuit interface
The following list describes the output for both serial line interfaces and
dial circuits.
- Nt
- Serial line interface number or dial circuit interface number.
- Nt'
- If "Nt" is a dial circuit, this is the interface number of the
V.25 bis serial line interface to which the dial circuit is
mapped.
- Interface
- Interface type and its instance number.
- Slot
- The slot number of the interface running V.25 bis.
- Port
- The port number of the interface that is running V.25 bis.
- Self-Test Passed
- Number of self-tests that succeeded.
- Self-Test Failed
- Number of self-tests that failed.
- Maintenance: Failed
- Number of maintenance failures.
- Adapter cable:
- Type of adapter cable that is being used.
- V.24 circuit:
- Circuit numbers as identified by V.24 specifications.
- RS-232
- EIA 232 (also known as RS-232) names for the circuits.
- State
- Current state of the circuits (ON or OFF).
- Line speed
- The transmit clock speed (approximate).
- Last port reset
- Length of time since the port was reset.
- Input frame errors:
-
- CRC error
- Number of packets received that contained checksum errors and as a result
were discarded.
- Alignment (byte length)
- Number of packets received that were not an even multiple of 8 bits in
length and as a result were discarded.
- Missed Frame
- When a frame arrives at the device and there is no buffer available, the
hardware drops the frame and increments the missed frame counter.
- too long (> nnnn bytes)
- Number of packets received that were greater than the configured frame
size and as a result were discarded.
- DMA/FIFO overrun
- The number of times the serial interface card could not send data fast
enough to the system packet buffer memory to receive packets from the
network.
- L & F bits not set
- On serial interfaces, the hardware sets input-descriptor information for
arriving frames. If the buffer can accept the complete frame upon
arrival, the hardware sets both the last and first bits of the frame,
indicating that the buffer accepted the complete frame. If either of
the bits is not set, the packet is dropped, the L & F bits not set counter
is incremented, and the buffer is cleared for reuse.
| Note: | It is unlikely that the L & F bits not set counter will be affected by
traffic.
|
- aborted frame
- Number of packets received that were aborted by the sender or a line
error.
- Output frame counters:
-
- DMA/FIFO underrun errors
- Number of times the serial interface card could not retrieve data fast
enough from the system packet buffer memory to transmit packets onto the
network.
- Output aborts sent
- Number of transmissions that were aborted as requested by upper-level
software.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]